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Preface 


The LEGO® TC logo Reference Guide is a complete, in- 
depth source of information on all LEGO® TC logo 
primitives, as well as a guide to some of the more 
technical aspects of LEGO® TC logo. 

The manual is divided into three sections: 

Section 1: Overview 

Provides information on how to use the LEGO® interface 
box and sensors, as well as a general overview of the 
LEGO® TC logo scrapbook. 

Section 2: LEGO® TC logo Primitives 
Provides a description of each LEGO® TC logo primitive 
including an example of its use. The primitives are in 
alphabetical order. 

Section 3: Appendices 

Provides information on LEGO® TC logo messages and 
includes a glossary and a list of all LEGO® TC logo 
primitives. The last appendix shows the range of screen 
coordinates for the turtle. 
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Section 1: Overview 


This section is an overview of the fundamental aspects of 
LEGO® TC logo. 

Chapter 1, The LEGO® Interface Box, describes the inlet and 
outlet ports on the LEGO interface box. 

Chapter 2, The LEGO Sensors, describes the function of the 
LEGO touch sensors and optosensors. 

Chapter 3, Using the LEGO® TC logo Scrapbook, describes 
the scrapbook, the pages of a disk, and how to transfer 
pages from one disk to another. 

Chapter 4, LEGO® TC logo Special Keys, describes the 
function of every special key used by LEGO® TC logo, 
whether for choosing or erasing pages or for word 
processing. 

The Setup Guide explains how to setup LEGO® TC logo 
hardware and software on your computer. 
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Chapter 1 

The LEGO® Interface Box 


The computer communicates with LEGO® pieces through 
the black interface box. The interface box has 12 sets of 
holes called ports. LEGO® wires can be plugged into any 
of these ports. 

Some of the ports are outlet ports. They are used to send 
commands, like on or off, to LEGO® motors and LEGO® 
lights. Other ports are called inlets. They are used to 
receive messages or information from LEGO® pieces called 
sensors. 

Outlets 

There are nine outlet ports. These are ports A, B, C, 0, 1, 

2, 3, 4, 5. 


Outlets 



li 











If you connect a light or motor to one of the numbered 
outlet ports (0, 1, 2, 3, 4, or 5), you can control: 

• Its brightness or speed. 

• Whether it is on or off. 

When you turn on a numbered port, the red light below 
the port lights up. 

Port A, port B, and port C are also called motor ports, 
since they are usually used for motors. If you connect a 
motor to port A, port B, or port C, you can control: 

• Its speed. 

• Whether it is on or off. 

• The direction in which it turns. 


When you connect a motor to a motor port, you can set the 
motor to turn in either of two directions. 

• When the motor turns in one direction, the light on the 
right side of the port (below the even numbered port) 
lights up. This direction is called the even direction. 

• When the motor turns in the other direction, the light on 
the left side of the port (below the odd numbered port) 
lights up. This direction is called the odd direction. 

If you want the computer to “talk to” an outlet port, you 
must tell it to do so by using the talkto command. 


The red stop button lets you stop motors quickly. When 
you press the button, you cut off power to all outlet ports, 
so all motors (and lights) turn off. Pressing the stop button 
again restarts them. 



Test Port 


Stop Button 
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The test port is located above the stop button. It is always 
on, even after you press the stop button. The test port acts 
as a signal to indicate whether or not power is being 
supplied to the system. You can also use it to test lights, 
motors, and your LEGO® models. You cannot control this 
port from the computer. 

Each lettered port (A, B, C) uses information from the 
numbered ports adjacent to it, so you cannot use these 
adjacent ports at the same time. For example, you cannot 
use port A and port 1 at the same time. 

Inlets 

There are two inlet ports, port 6 and port 7. These ports 
are used to receive information from the LEGO® sensors. 
You can connect touch sensors or optosensors to inlet 
ports. The sensors report either true or false. 


Inlets 

I 
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The green light under an inlet port lights up whenever the 
sensor connected to the port reports true. A touch sensor 
reports true when its button is pressed. An optosensor 
reports true when it detects a sharp decrease in the level of 
light. See Chapter 2, The LEGO® Sensors, for more details. 

To get the computer to “listen to” a port, you must use the 
listento command. When you start up LEGO® TC logo, the 
computer is “listening to” both port 6 and port 7. 
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Chapter 2 

The LEGO® Sensors 


There are two types of LEGO® sensors: optosensors and 
touch sensors. A sensor always reports either true or false. 



Touch Sensor 



Optosensor 


Inlet ports are used to receive information from LEGO® 
sensors. You can connect a sensor to either port 6 or 
port 7. You can use both ports at the same time. 

Touch Sensors 

The touch sensor consists of a touch sensor brick with a 
gray button. The gray button acts as a push button. A 
small axle can be placed into the gray button to extend it. 
If something is pressing the button, the sensor reports 
true. If nothing is pressing it, the sensor reports false. 
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You can use the touch sensor in a variety of projects. For 
example, you can use it to detect whether the door on a 
LEGO® washing machine is open or closed. You can build 
the washing machine so that the button on the sensor is 
held down when the door is closed. When the door is 
closed the sensor reports true. When the door is open, the 
sensor reports false. You can also use the sensor to create 
a stop watch or to detect when a LEGO® car has reached a 
wall. 

You can use a computer’s counter to count the number of 
times a touch sensor is pressed. Every time the sensor 
changes from false to true, the counter automatically 
increases by one. 

Optosensors 

The optosensor detects sharp changes in the level of light. 

If the last sharp change was from light to dark, the sensor 
reports true. If the last sharp change was from dark to 
light, it reports false. 

The optosensor reacts only to sharp changes in light. If the 
light has been changing very gradually, the reading from 
the optosensor will be unreliable. The optosensor reading 
is also unreliable when you first start LEGO® TC logo. You 
should “initialize” the optosensor by exposing it to 
several sharp changes in light. For example, you can 
initialize the optosensor by moving it from a dark surface 
to a light surface, or by placing the sensor across from a 
LEGO® light and flashing the light several times. You must 
initialize the optosensor each time you use it. 

The optosensor works with either directed light or reflected 
light. 
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Directed Light 

An optosensor can detect light from a LEGO® light that 
is less than 30 centimeters away. If the light is on and an 
object passes in front of the light, blocking the path between 
the light and the sensor, the sensor reports true. If the light 
is on, and no object is blocking the light, the sensor reports 
false. You can use an optosensor and light to build an 
automatic door or a burglar alarm. 



If the light in a room is very bright, the optosensor may not 
give accurate information. The sensor may confuse the light 
in the room with the light from the LEGO light. This might 
also happen if the optosensor is more than 30 centimeters 
away from the LEGO light. 

Reflected Light 

A tiny infrared light transmitter is built into the 
optosensor. If you place a surface next to the optosensor, 
the infrared light reflects off the surface and back to the 
sensor. Since white surfaces reflect more light than dark 
surfaces, the optosensor can detect changes in the color of 
the surface passing in front of it. 

• If the surface passing in front of the optosensor changes 
from white to black, the sensor reports true. The green 
light at the inlet port on the interface box turns on. 

• If the surface passing in front of the optosensor changes 
from black to white, the sensor reports false. The green 
light at the inlet port on the interface box turns off. 
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The sensor should be about three millimeters from the 
reflecting surface. For example, you can attach an 
optosensor to the front of a LEGO® car, three millimeters 
above the ground. The sensor will detect whether the car 
moves from a light surface to a dark surface or from a dark 
surface to a light surface. 



You can also use an optosensor with a counting wheel, a 
special black/white LEGO disk. A counting wheel has 
black and white slices printed on it. There are four slices 
of each color on one side and eight slices of each color 
on the other side. Place the optosensor three millimeters 
from the counting wheel. When the surface across from 
the sensor changes from a white slice to a black slice, 
the sensor reports true. When the surface across 
from the sensor changes from a black slice to a white 
slice, the sensor reports false. 



A computer’s counter automatically increases by one every 
time the sensor changes from false to true. If the sensor is 
next to a counting wheel, you can use the counter to 
calculate the number of times the counting wheel has 
turned. 
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Chapter 3 

Using the LEGO® TC logo 
Scrapbook 


Your LEGO® TC logo disk includes the LEGO® TC logo 
program plus a scrapbook. The scrapbook is a set of 
LEGO® TC logo pages. Each page is a file that can contain 
LEGO® TC logo procedures, text, and graphics. One page - 
the turtle page - is already on the disk. You can add new 
pages as you create procedures, text, and graphics. 

A scrapbook also includes the Contents menu, which lists 
all the pages in the scrapbook. 

Contents 

From the Contents menu, you can choose a page on which 
to work, or you can erase one or more pages from the 
scrapbook. 

To choose a page, use the arrow keys to move the cursor to 
the page name and press Return Enter. 

To erase a page from the scrapbook, move the cursor to the 
page name and press the erase to end of line keys (f$-6 F6. 

Warning: Once you erase a page, you cannot recover it. 
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A Scrapbook Page 

Each page has two sides: 

The procedure side of the page, where you can define 
procedures. 

The turtle side of the page, where you can draw graphics 
and write text. 

The area at the bottom of the screen is called the 
Command Center. This is where you type instructions. 

It is not part of the page. 

When you select a LEGO® TC logo page, you start on the 
procedure side of the page. 

The Size of a Page 

There is a limit to the number of characters you can put on 
a page. On Apple computers, you can put a total of 4030 
characters on a page (front and back). On IBM computers, 
the limit depends on the amount of memory left when the 
LEGO® TC logo software is loaded. The maximum is 
32,000 characters on the front and 32,000 characters on the 
back. 

The Page and the Workspace 

Your workspace is the part of the computer’s memory that 
is available for use. It contains all of the procedures from 
the procedure side of the page, plus the values for all 
variables you have created. 

The size of a page is not the same as the size of your 
workspace. The text on the turtle side of the page is not 
part of the workspace. 
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Saving a Page 

When you save a page to the disk, you save all of the text 
and graphics and procedures on the page. 

The page is saved automatically whenever you: 

• Press Escape to go to Contents. 

• Use getpage or newpage to get another page. 

Before saving a page, you must give the page a name using 
the namepage command. 

LEGO® TC logo will save a page even if procedures on the 
page contain bugs. There are specific bugs that occur, 
however, that force LEGO® TC logo to print an error 
message and prevent you from running the procedure until 
the bug is fixed. Two important cases include: unmatched 
brackets in procedures and a procedure name the same as a 
primitive name. In these cases you must correct the error 
before LEGO® TC logo allows you to continue. 

Saving Variables 

Variables are not saved on a page. If you want to save a 
variable, you must add the make or name instructions that 
create the variable to a procedure on the procedure side of 
the page. 

The Turtle Page 

The turtle page contains special procedures that let you 
control the LEGO® turtle. To access the turtle page, select 
it from the Contents menu. 

The procedures included on the turtle page are: 

tfd time 

Stands for turtle forward. Moves the LEGO® turtle forward 
for time tenths of a second. 
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tbk time 

Stands for turtle back. Moves the LEGO® turtle back for 
time tenths of a second. 

trt time 

Stands for turtle right. Turns the LEGO® turtle to the right 
for time tenths of a second. 

tit time 

Stands for turtle left. Turns the LEGO® turtle to the left for 
time tenths of a second. 

gofd 

Tells the turtle to start moving forward. The LEGO® turtle 
will continue moving forward until you give it an 
instruction to do something else. 

gobk 

Tells the LEGO® turtle to start moving backwards. The 
turtle will continue moving back until you give it an 
instruction to do something else. 

gort 

Tells the LEGO® turtle to start turning right. The turtle 
will continue turning right until you give it an instruction 
to do something else. 

golf 

Tells the LEGO® turtle to start turning left. The turtle will 
continue turning left until you give it an instruction to do 
something else. 

offturtle 

ot 

Tims off the LEGO® turtle’s motors causing it to stop 
moving. 
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Note: Any changes you make to the page will be saved 
when you press Escape and go to the Contents menu or 
when you get another page. If you plan to change these 
procedures or add new ones, you should give the page a 
new name. In this way, the original turtle page will not be 
changed and the procedures will be available when you 
need them. 

To rename the page, type: 
namepage "myturtle 

Changing Disks 

You can change disks at any time while using LEGO® TC 
logo. 

If you change disks while a page is on the screen and then 
press Escape, the page will be saved on the new disk. To 
change disks without transferring pages: 

• Press Escape to go to Contents. 

• Change disks. 

• Press Escape again. Contents will list the pages on the 
new disk. 

Copying a Page onto Another 
LEGO® TC logo Disk 

Follow these steps to copy a page onto another disk. 

• With the source disk in the disk drive, go to the page 
you want to copy. 

• Remove the source disk and insert the destination disk - 
the disk onto which you want the page copied. 

• Press Escape. The page is automatically saved on the 
destination disk. 
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Chapter 4 

LEGO® TC logo Special Keys 


Special keys and key combinations provide an easy way of 
carrying out certain functions in LEGO® TC logo. Here is 
a complete listing of LEGO® TC logo’s special keys and 
their functions. 

To carry out special commands on Apple computers, you 
generally use key combinations with the Apple key 
Just hold down the key, then press the other key. For 
example, to flip the page, hold down the (5 key and 
press the F key. 

To carry out special commands on IBM and IBM-compatible 
computers, you generally use either the special function 
keys (Fl through F10) or key combinations with the 
Control (Ctrl) key. To use a key combination, hold down 
the Ctrl key, then press the other key. For example, to 
flip the page, hold down the Ctrl key and press the F key. 

General Purpose Keys 

Flip Keys (5-F Ctrl-F 

The flip keys flip the page from the procedure side to the 
turtle side or from the turtle side to the procedure side. 

Up Keys (3-U Ctrl-U 

The up keys move the cursor from the command center to 
the page. Use these keys when you want to type a 
procedure definition on the procedure side of the page or 
when you want to type text on the turtle side. 

Down Keys (5-D Ctrl-D 

The down keys move the cursor from the page to the 
command center. 
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Escape Esc Esc 

The Escape key saves the page that is displayed and 
brings the Contents menu to the screen. 

Stop Keys (5-S Ctrl-S or Ctrl-Break 

The stop keys stop any program or instruction which is 
running, returning you to the command center. 

Open a Line Keys (5-0 Insert 

The open a line keys insert a blank line at the cursor. 

Contents Menu Keys 

Up and Down Arrow Keys 11 ft 

The up and down arrow keys move the cursor up and 
down through the names of the pages that are in the 
scrapbook. 

Top of Page Keys (5-t Home 

The top of page keys move the cursor to the top of the 
Contents menu. 

Bottom of Page Keys (5-1 End 

The bottom of page keys move the cursor to the last page 
name in the Contents list. 

Previous Screen Keys ( 5 - <_ Pg Up 

The previous screen keys display the previous screenful of 
page names (if there is one). 

Next Screen Keys (5-“* Pg Dn 

The next screen keys display the next screenful of page 
names (if there is one). 

Return Return H (Enter) 

Return Enter displays the page named on the line that the 
cursor is on. 

Escape Esc Esc 

Escape updates the Contents menu. Use this key after 
changing disks. 
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Erase to End of Line Keys (5-6 F6 

The erase to end of line keys erase the page named on the 

line that the cursor is on. 

Warning: When you erase a page, it is permanently erased. 
You cannot recover an erased page. 

Word Processing Keys 

Select Keys (5-1 Fl 

The select keys start the “select mode.” When you are in 
select mode, you can select text that you want to cut or 
copy. To select text, move the cursor over the text. The 
selected text is highlighted in inverse video. This text can 
then be cut with the cut keys or copied using the copy 
keys. 

Cut Keys (5-2 F2 

The cut keys remove the selected text, storing it in a 
section of the computer’s memory called the Clipboard. 
Any text previously in the Clipboard is erased from 
memory. 

Copy Keys (5-3 F3 

The copy keys store a copy of the selected text in a section 
of the computer’s memory called the Clipboard. Any text 
previously in the Clipboard is erased from memory. 

Paste Keys (5-4 F4 

The paste keys insert the text that is stored in the 
Clipboard onto the page at the cursor position. 

Escape Esc Esc 

If you are in select mode, Escape turns the mode off. If 
you are not in select mode, Escape saves the page and 
brings the Contents menu to the screen. 

Erase to End of Line Keys (5-6 F6 

The erase to end of line keys erase all the text from the 
cursor position to the end of the line. This text is not 
stored in the Clipboard and cannot be recovered. 
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Next Screen Keys (5--* Pg Dn 

The next screen keys display the next screenful of text (if 
there is any). 

Previous Screen Keys (5 - Pg Up 

The previous screen keys display the previous screenful of 
text (if there is any). 

Top of Page Keys (5 -1 Home 

The top of page keys move the cursor to the beginning of 
the text. 

Bottom of Page Keys (5 - l End 

The bottom of page keys move the cursor to the end of the 
text. 

Beginning of Line Keys (3-B Ctrl- <- 

The beginning of line keys move the cursor to the 
beginning of the line that the cursor is on. 

End of Line Keys 6-E Ctrl- -> 

The end of line keys move the cursor to the end of the line 
that the cursor is on. Apple users: The “end of the line” is 
where the next carriage return character is. If you typed 
several lines without pressing Return , the end of the line 
may be several screen lines below the cursor. IBM users: 

The end of a line is the right margin. 

Delete the character under 

the cursor Control-D Delete 

Delete the character to the 
left of the cursor Delete f - 

Note: All of these key combinations work on either the 
page or the Command Center. If the cursor is on the page, a 
key combination affects the page. If the cursor is in the 
Command Center, a key combination affects the Command 
Center. 
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Section 2: LEGO® TC logo 
Primitives 


This chapter consists of a description of each LEGO® TC 
logo primitive. 

Each primitive is described in the same way. 

Here is an example of how a primitive is described: 

1 forward number 2 4 Command/1 input 5 

3 fd number 

6 Move the turtle forward a distance of number steps. 
Example: 

7 r g 

fd 50 
rt 90 

repeat 50 [fd 21 

1 Primitive name. 

2 Type of input. 

3 Short form. 

4 Type of primitive (command, reporter, or special word). 

5 Number of inputs most commonly used. 
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6 Definition. 

7 Examples of use. 

Here is an example of how the top line would look for a 
primitive with more than one choice of inputs: 


print word/list 
pr word/list 

8 (print word/listl word/list2...) Command/1 input 

If inside parentheses, one or many inputs. 


8 Shows that any number of inputs can be used. If you 
use a different number of inputs from the number most 
commonly used, the primitive and its inputs must be 
enclosed in parentheses. 

Input Words 


Here is an alphabetical listing of the types of inputs that 
LEGO® TC logo primitives use. Beside each word is a 
description of what the actual input must be. 


Type of Input 

buttonnumber 

char 

degrees 


Real Input 

Either 0 or 1. 

A letter of the alphabet, number, 
or punctuation mark. 

Degrees of an angle. A number 
between -10000 and 10000. 
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frequency 

letter 

A number from 37 to 9999. 

A letter of the alphabet. 

level 

An integer from 1 to 7. 

list 

Information enclosed in brackets 
[]• 

list-to-run 

A list of procedures or 
primitives that LEGO® TC logo 
can run. 

name 

A word naming a procedure or a 
variable. 

number 

A number between -10000 and 
10000. 

paddlenumber 

An integer from 0 to 3. 

pagename 

The name of a LEGO® TC logo 
page. 

port 

An integer from 0 to 7 or A, B, 
or C. 

portlist 

A list of any of the integers from 
0 to 7 and/or A, B, C. 

time 

A number from 0 to 9999 
(unless otherwise specified); 
time specified in ticks, each tick 
equal to 1/10 second. 
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timernumber 

An integer from 0 to 3. 

true/false 

A primitive or procedure that 
reports the word true or the 
word false. 

true/false-list 

A list containing a primitive or 
a procedure that reports the 
word true or the word false. 

turtle 

An integer from 0 to 3. 

turtlelist 

A list of any of the integers from 
0 to 3. 

word 

A sequence of characters (not 
including spaces). A number is 
a type of word. 

word/list 

A word or a list. 

fxyj 

A list of two numbers giving the 
coordinates of the turtle. 
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Arithmetic Primitives 


Note: In some versions of LEGO® TC logo, it is necessary 
to put spaces before and after arithmetic primitives. For 
example, you must use 5 + 3 not 5 + 3. 


number 1 + number2 (Addition) Reporter/2 inputs 

Reports the sum of number 1 and number2. 

Example: 

show 5+3 
8 


numberl - number2 (Subtraction) 

Reporter/2 inputs 

Reports the difference between numberl and number2. 
Example: 

show 8-3 

5 


numberl * number2 (Multiplication) 

Reporter/2 inputs 

Reports the product of numberl multiplied by number2. 
Example: 

show 2*3 

6 
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number 1 / number2 (Division) Reporter/2 inputs 

Reports the value of numberl divided by number2. 
Example: 

show 12/3 

4 


word/listl = word/list2 (Equal to) 

Reporter/2 inputs 

Reports true if word/listl and word/list2 are equal 
numbers or the same words or lists; otherwise, it reports 
false. Two words are considered equal even if one uses 
capital letters and the other doesn’t. 

See equal? and identical? 

Examples: 

show 8=7 

false 


show 

4*4 = 

16 

true 



show 

"he 1 1 o 

= "HELLO 

true 



show 

"hello 

= [hello! 


false 
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numberl > number2 (greater than) 

Reporter/2 inputs 


Reports true if numberl is greater than number2; 
otherwise, it reports false. 

Example: 

show 8 > 3 

true 


numberl < number2 (less than) Reporter/2 inputs 


Reports true if number 1 is less than number2; otherwise, 
it reports false. 

Example: 

show 8 < 3 

false 
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A 


all 

Reporter/No inputs 

Reports the list of turtles [0123]. 

See tell. 

Example: 


r 9 

tell all 

5 t 

fd 50 
show who 

[0 1 2 31 

All 4 turtles appear. 

All 4 turtles move forward. 

alloff, ao 

Command/No inputs 


Resets all outlet ports to their original state: all motors and 
lights are turned off, each port is set to the even direction 
(ports 0, 2, 4) and to its maximum power level (7), and 
no ports are being addressed (“talked to”). 

See off, on, and talkto. 

Example: 

talkto [a bl 
on 

tto 5 
on 

a 11 of f 


36 


and true/falsel true/false2 

(and true/falsel true/false2 true/false3...) 

Test Reporter/2 inputs 
If inside parentheses, one or many inputs. 


Reports true if all of its inputs report true; otherwise, it 
reports false. 

Examples: 

show and (5 = 5) ("A = "A) 

true 

if and sensor? (counter > 10) tonfor 71 


ascii char Reporter/1 input 


Reports the ASCII number which represents the character. 
Examples: 

show ascii "a 

97 

show ascii "b 

98 
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ask turtle list-to-run 
ask turtlelist list-to-run 

Command or Reporter/2 inputs 

Temporarily addresses the turtle or turtles named, giving 
them the instructions in the instruction list. This does not 
change the list of turtles which was set by the last tell 
instruction. 

If list-to-run is a reporter, ask reports whatever the 
reporter outputs. 

See tell. 

Examples: 

r 9 

tell all 5 1 
fd 50 

ask 0 trt 451 
ask [1 2 3] tit 

fd 50 


All 4 turtles move forward. 
Only turtle 0 turns. 

45 ] Only turtles 1, 2, 3 turn. 

All 4 turtles move forward. 
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B 


back number Command/1 input 

bk number 


Moves the turtle backwards a distance of number steps. 
Examples: 

r 9 

back 50 
rt 90 
back 50 


butfirst word/list Reporter/1 input 

bf word/list 


Reports all but the first element of the word or list. 

Examples: 

show bf "hello 
e 11 o 

show bf [one two 3 4 five] 

[two 3 4 five] 


butlast word/list Reporter/1 input 

bl word/list 


Reports all but the last element of the word or list. 
Examples: 

show bl "goodbye 
goodby 

show bl [one two 3 4 five] 

[one two 3 4] 
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button? buttonnumber 


Test Reporter/1 input 


Reports true if the button buttonnumber on a game paddle 
(or joystick) is pressed; otherwise, it reports false. 

Examples: 

show button? 1 
false 

Define this procedure. 

to check 

if button? 1 [stop] 

fd 1 

check 

end 

In the command center, type: 

check The turtle moves forward until 

you press the button on paddle 
1 (or button 1 on the joystick). 
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c 


cc Command/No inputs 

Stands for clear commands. Clears all text from the 
command center. 


eg 

Command/No inputs 

Stands for clear graphics. Clears all lines drawn and all 
text printed with the label command. Each turtle that is 
following instructions returns to its home position, 
pointing upwards. 

See clean and rg. 

Example: 


r 9 

fd 50 

label "hello 

hello 

hello appears on the page, 
next to the turtle. 

pr "there 

there 

c 9 

there appears on the page. 
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char number 

Reporter/1 input 

Reports the text character with the ASCII code of number. 

Examples: 


show char 65 

A 

show char 32 

An empty space is 
printed. 

show char 97 

a 


clean 

Command/No inputs 


Erases all lines drawn and all text printed with the label 
command, without changing the turtles’ positions. 

See eg and rg. 

Example: 

r 9 

fd 50 
clean 
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clearnames 


Command/No inputs 


Clears all variable names and their values from memory. 
Variables are created with the make and name primitives. 
See make and name. 

Examples: 

name "Bob "friend 

make "class [Seth Anne Zachary Genii 

show :f riend 

Bob 

c1ea r name 5 
show :f riend 

friend has no value 

show :class 

class has no value 
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clearpage 


Command/No inputs 


Clears all text and graphics from both sides of the page. 

Apple users: This erases all procedures as well as clearing 
all other text and graphics. If you clear a page accidentally, 
use the restore command to bring back the version of the 
page that is on the disk. See restore. 

IBM users: Clears the page and also changes the name. 

Use getpage to get back a previous version of the page. 

Example: 

newpage 

Define this procedure. 

to square 

repeat 4 [fd 50 rt 90] 
end 

In the command center, type: 

square The turtle draws a square. 

clearpage 

square 

I don't know how to square. 
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cleartext 


Command/No inputs 

Clears all the text from the side of the page that is 
displayed. Does not affect any text that has been printed 
with the label command. 

Note: Clearing the text on the procedure side of the page is 
one way to erase all of the procedures on the page. 

Example: 

print "hello 

hello hello is printed on the page. 

cleartext 


contents Command/No inputs 

Saves the current page, then displays the Contents menu 
from which you can access or erase any page on the disk. 


COS degrees Reporter/1 input 

Stands for cosine. Reports the cosine of degrees. 

Examples: 

show co5 45 
0.7071 
seth 90 

show cos heading 
0 


45 










count word/list 

Reporter/l input 

Reports the number of elements in the word or list. If the 
input is a word, count reports the number of letters in the 
word. If the input is a list, count reports the number of 
items (words or lists) in the list. 

Examples: 


show count "hello 

5 

show count tone one one] 
3 

show count [ ] 

0 


counter 

Reporter/No inputs 


Reports the number of times the state of a sensor changed 
from false to true since the last resetc command. The 
counter automatically increases by one every time a touch 
sensor is pressed or an optosensor detects a change from 
light to dark. If both port 6 and port 7 were named in the 
last listento instruction, counter reports a list with two 
values. The value of the counter attached to port 6 is listed 
first. Resetc resets the counter(s) to 0. 

See listento, resetc, and Chapter 2, The LEGO® Sensors. 

Examples: 

listento 7 
show counter 
2 

resetc 

listento 16 71 
show counter 
[3 01 
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D 


disk 

Reporter/No inputs 

Reports the letter representing the current disk drive. 

See setdisk. 

Example: 


show disk 

A 


dos 

Command/No input 


Exits the LEGO® TC logo software and returns to the DOS 
operating system. Dos is a primitive in only the IBM 
version of LEGO® TC logo. 
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E 


each list-to-run Command/1 input 

Makes each turtle that is following commands run the 
instructions in Jist-to-run. If there is more than one turtle 
following commands, the first turtle runs all the 
instructions in list-to-run, then the second turtle runs all 
the instructions, and so on. 

See who. 

Examples: 

r 9 

tell [01231 

5 t 

each [repeat 4 [fd 20 rt 90]] 

Each turtle draws a square. 

tell [1 3] 

each [seth (90 * who) fd 80] 

Turtle 1 sets its heading to 90 
then moves forward. Turtle 3 
sets its heading to 270, then 
moves forward. 
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empty? word/list Test Reporter/1 input 

Reports true if word/list is an empty word or an empty 
list; otherwise, it reports false. 

Examples: 

show empty? [] 

true 

show empty? [ 0 ] 

false 

make "test [person] 
show empty? :test 

false 

make "test2 butfirst [person] 
show empty? :test2 

true 


end Special Word 


Indicates the end of a procedure definition and separates 
procedures from one another on the page. 

Examples: 

to square 

repeat 4 [fd 50 rt 90] 
end 

to triangle 

repeat 3 [fd 30 rt 120] 
end 
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equal? word/listl word/list2 

Test Reporter/2 inputs 


Reports true if word/listl and word/list2 are the same, 
even if one uses a capital letter and the other one doesn’t; 
otherwise, it reports false. A word is not equal to a list 
containing that word. 

See identical? and =. 

Examples: 

show equal? "a "A 

true 

show equal? "one 1 
false 

show equal? [hello] [hello] 

true 

show equal? "hello [hello] 

false 


erpage pagename Command/1 input 

Stands for erase page. Erases the page from the scrapbook 
on the disk. Use with caution - once a page is erased, you 
cannot get it back. 

Example: 

erpage "traffic The page named t r a f f i c is 

erased from the disk. 
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F 


false Special Word 


Reports false. Used as input to if, ifelse, and, or, not, =, 
and equal? 

Examples: 

ifelse "false [show "yes] [show "no] 
no 

if sensor? = "false [onfor 20] 


first word/list Reporter/1 input 


Reports the first element of word/list. First of a word is a 
single character; first of a list can be a word or a list. 

Examples: 

show first "hello 

h 

show first [three two one go] 

three 

show first [[my name is] [Joe Smith]] 

[my name is] 


51 










flash time 1 time2 Command/2 input 


Tells motors and lights to begin flashing - turning on for 
time 1 tenths of a second and then off for time2 tenths of a 
second. Flashing will continue until an on, onfor, or off 
command is given. Flash affects only motors and lights 
connected to numbered outlet ports (0, 1, 2, 3, 4, and 5) 
named in the last talkto instruction. Timel and time2 can 
be any number from 1 to 99. 

See talkto. 

Example: 

talkto 1 
flash 15 5 


forward number Command/1 input 

fd number 


Moves the turtle forward a distance of number steps. 
Examples: 

r 9 

fd 50 
rt 90 

repeat 50 [fd 21 


fput word/list list Reporter/2 inputs 

Stands for first put. Reports a new list which is formed by 
putting word/list at the beginning of list. 

Examples: 

show fput "i [do it] 

[i do it] 

show fput [i] [do it] 

[[i] do it] 
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G 


getpage pagename Command/ 1 input 

8P pagename 

Saves the current page and displays the page pagename. 
Any procedures on the new page can be used. If 
pagename does not exist, a message is displayed. 

Example: 

getpage "traffic 
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H 


heading 

Reporter/No inputs 

Reports the turtle’s heading in degrees, from 0 to 

359.9999. If more than one turtle is following commands, 
heading reports the heading of the first turtle in the list 
reported by who. 

See seth. 

Examples: 


r 9 

show heading 

0 

rt 45 

show heading 

45 

if heading = 45 [show 
northeast 

"nor theas t] 

home 

Command/No inputs 

Moves each of the turtles to its 
sets its heading to 0. 

own home position and 

Example: 


r 9 

tell all 

5 t pu 
rt 45 
fd 50 
home 
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ht Command/No inputs 

Stands for hide turtle. Makes the turtle invisible. 

Example: 

ht 

repeat 4 [fd 50 rt 90] 

5 t 
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I 


identical? word/listl word/list2 

Test Reporter/2 inputs 


Reports true if the two words or lists are equal numbers, 
identical words, or identical lists; otherwise, it reports 
false. A word is not identical to a list containing the same 
word. Corresponding characters of each input must match 
in terms of uppercase and lowercase characters. 

See equal? and =. 

Examples: 

show identical? "one "One 

false 

show identical? tone! lone] 

true 

show identical? "one [one] 
false 


if true/false list-to-run Command/2 inputs 


The first input, true/false, must be a condition that reports 
true or false. If true/false reports true, list-to-run is run; if 
true/false reports false, list-to-run is ignored. 

Examples: 

if 25 + 25 = 50 [show [that's right]] 
[that's right] 
if sensor? [off] 


56 


ifelse true/false list-to-runl list-to-run2 

Command or Reporter/3 inputs 


The first input, true/false, must be a condition that reports 
true or false. If true/false reports true, list-to-runl is run; 
if true/false reports false, list-to-run2 is run. 

Examples: 

ifelse 100 < 50 [show "less] [show "more] 
more 

ifelse counter = 4 [rd] [show counter] 


insert word/list 

(insert word/listl word/list2...) Command/1 input 
If inside parentheses, one or many inputs. 


Inserts a word or a list at the cursor position on the page 
without adding a carriage return (the cursor does not move 
to the next line). 

See print, show, and type. 

Examples: 

c 1 ea r page 

insert "hello insert [hello there] 
heliohello there This text appears on the page, 

cleartext 

print "hello insert [hello there] 
hello This text appears on the page, 

hello there 
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item number word/list 


Reporter/2 inputs 


Reports the numberth element of the word or list. 
Examples: 

show item 4 [which word is the fourth] 
the 

show item 2 "hello 
e 
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K 


key? 


Test Reporter/No inputs 


Reports true if a key has been pressed on the keyboard 
and the key has not yet been read by readchar, readlist, or 
readlistcc; otherwise, it reports false. 

See readchar, readlist, and readlistcc. 

Example: 

show key? 

false 

wait 50 show key? 

Immediately after pressing 
Return Enter, press a key. 

true 

a Whatever key you pressed is 

printed in the Command Center. 
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L 


label word/list Command/1 input 

Prints the word or list as graphics. The text is printed next 
to each turtle named in the most recent tell command. Text 
printed in this way is not part of the regular text: it 
doesn’t scroll and cannot be edited with the text editing 
keys. Text that is printed with label can be erased either 
by labeling the same letters again or by clearing the 
graphics with eg, clean, or rg. 

See print and insert. 

Examples: 

r 9 

pu ht 

1abe1 "hello 

hello hello appears next to the turtle. 

bk 10 

label "there 

there there appears next to the 

turtle. 

c 9 

tell CO 11 
label "hello 

hello hello appears next to turtle 0 

and turtle 1. 
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last word/list Reporter/1 input 

Reports the last element of word/list. 

Examples: 

show last “hello 
o 

show last [three two one go] 

9° 


left degrees Command/1 input 

It degrees 


Turns the turtle degrees to the left. 

Examples: 

It 90 
fd 50 
It 45 


list word/listl word/list 2 

(list word/listl word/list2 word/list3...) 

Reporter/2 inputs 
If inside parentheses, one or many inputs. 


Reports one list made up of word/listl and word/list2. 
Examples: 

show list "hello "there 

[hello there] 

show list [hello] [there] 

[[hello] [there]] 
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list? word/list Test Reporter/1 input 


Reports true if word/list is a list; otherwise, it reports 
false. 

Examples: 

show list? [hello there] 
true 

show list? "hello 
false 

show list? [ ] 

true 


listento port/portlist 

lto port/portlist Command/1 input 


Sets which inlet port or ports will be used to receive 
information (messages) from the sensors. The inlet ports 
are port 6 and port 7. If a list of ports is used, 6 must be 
listed before 7. 

See sensor?, talkto, Chapter 1 , The LEGO® Interface Box, 
and Chapter 2, The LEGO Sensors. 

Examples: 

listento G 
show sensor? 
true 

lto [6 7] 
show counter 
[1 0 ] 
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load pagename 

Command/1 input 

Loads the procedures from pagename onto the page that is 
showing. These procedures are added to the procedures 
that are already there. 

Example: 


load "traffic 


lput word/list list 

Reporter/2 inputs 


Stands for last put. Reports a new list which is formed by 
putting word/list at the end of list. 

Examples: 


show lput 
[I do it] 
show lput 


'it El do] 


[it] [I do] 


[I do [it ] ] 
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M 


make name word/list Command/2 inputs 


Creates a variable, name, and gives it the value word/list. 
In general, variables created with make are “global” and 
remain in the computer’s memory even when the page is 
changed. The only exception is when a make instruction 
inside a procedure uses the same name as a variable on 
the title line of the procedure. In this case, the variable’s 
value is “local,” in memory only while the procedure is 
running. 

A variable is not saved on a page unless you put an 
instruction creating the variable inside a procedure 
definition. Once you create a variable, you can access its 
value with -.name or thing “name. The : (colon) means 
“the value of.” 

See clearnames, name, and thing. 

Examples: 

make "class [Zachary Anne Seth Genii 
show :class 

[Zachary Anne Seth Genii 
make "button 6 
listento rbutton 
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member? word/listl word/list2 

Test Reporter/2 inputs 

Reports true if word/listl is an element of word/list2 ; 
otherwise, it reports false. 

Examples: 

show member? "o "hello 
true 

show member? "there [hello there! 
true 

show member? "o [hello there! 

false 


minus number 


Reporter/1 input 


Reports the additive inverse of number. Minus is 
particularly useful when working with variables. In the 
IBM version, you cannot use a minus sign (-) to get the 
additive inverse of a variable or of a reporter. 

Examples: 

show minus 3 
-3 

make "savings 100 
show minus : savinqs 
-100 
seth 90 

show minus heading 
-90 
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N 


name word/list name Command/2 inputs 

Creates a variable, name, and gives it the value word/list. 
In general, variables created with name are “global” and 
remain in the computer’s memory even when the page is 
changed. The only exception is when a name instruction 
inside a procedure uses the same name as a variable on 
the title line of the procedure. In this case, the variable’s 
value is “local,” in memory only while the procedure is 
running. 

Name’s function is identical to make, but the inputs are in 
the reverse order. A variable is not saved on a page unless 
you put an instruction creating the variable inside a 
procedure definition. 

See clearnames, make, and thing. 

Examples: 

name 0 "light 
name 6 "button 
talkto :light 
flash 10 5 
listento ibutton 


namepage pagename Command/1 input 

np pagename 


Names the current page. In the IBM version, namepage 
also saves the current page to the disk. 

Example: 

newpage 

namepage "traffic 
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name? word Test Reporter/1 input 

Reports true if word is the name of a variable (if word has 
a value); otherwise, it reports false. 

See name and make. 


Examples: 


make 

"myn 

ame 

"Sa 

m 

name 

-Cat 

h y 

"f r i 

en 

show 

name 

? 11 

myna 

me 

true 





show 

name 

? 11 

f r i e 

nd 

true 





show 

name 

? 11 

Sam 



false 


newpage Command/No inputs 


Saves the current page and displays a new page. The new 
page has no name ( ? ? ? appears in the title position). You 
must give the new page a name with namepage before you 
can save it. 

Example: 

newpage 

namepage "washer 


67 










not true/false Test Reporter/1 input 


Reports the logical inverse of its input; if true/false is true, 
not reports false. If true/false is false, not reports true. 

The input to not must report either true or false. 

Examples: 

show not "t rue 
false 

show 1 = 2 

false 

show not 1 = 2 

true 

if not sensor? tonfor 12 rdl 


number? word/list Test Reporter/1 input 


Reports true if its input is a number; otherwise, it reports 
false. A number is a kind of word. 

Examples: 

show number ? 12 

true 

show number? [221 
false 

show number? 22/3 

true 
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o 


off _ Command/No inputs 

Turns off motors and lights connected to the outlet port(s) 
named in the last talkto instruction. 

See alloff. 

Example: 

talkto 1 

on 

off 


on 


Command/No inputs 


Turns on motors and lights connected to the outlet port(s) 
named in the last talkto instruction. 

See off and onfor. 

Example: 

talkto 1 
on 
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onfor time Command/1 input 

Turns on motors and lights for time tenths of a second. 
Onfor affects only motors and lights connected to the 
outlet port(s) named in the last talkto instruction. Onfor 
10 turns on devices for one second. Onfor truncates 
decimal values from the input: e.g. onfor 1.9 is the same 
as onfor 1. 

See on. 

Examples: 

talkto 1 
onfor 20 
tto [a bl 
onfor 15 


or true/falsel true/false2 

(or true/falsel true/false2 true/false3...) 

Test Reporter/2 inputs 
If inside parentheses, one or many inputs. 


Reports true if any of its inputs report true; otherwise, it 
reports false. Or’s inputs must report true or false. 

Examples: 

show or "true "false 
true 

show or (5 = 3) (2 = 2) 

true 

waituntil [or sensor? counter > 51 
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output word/list 
op word/list 


Command/1 input 


Stops the running procedure and reports word/list. Output 
can be used only within a procedure. It is used to create 
procedures which are reporters. 

Example: 

Define this procedure. 

to squared rnumber 
output :number * rnumber 
end 

In the command center, type: 

show squared 10 

1 00 


71 








p 


paddle paddJenumber Reporter/1 input 

Reports a number which indicates the position of the dial 
on game paddle paddJenumber or the position of stick 
paddJenumber on a joystick. Paddle reports a number from 
0 through 255 on Apple computers. For IBM users the 
maximum depends upon the type of paddle used. Refer to 
your IBM documentation. 

Example: 

show paddle 0 

4 4 The number will vary, depending 

on the paddle position. 


pagelist 


Reporter/No inputs 


Reports a list of the names of all the LEGO® TC logo pages on 
the disk. On IBM computers the list is in alphabetical order. 

Example: 

show pagelist 

[car traffic washer! 



Command/No inputs 


Stands for pen down. Puts the turtle’s pen down. When 
the turtle moves, it draws lines. The turtle always starts 
with its pen down. 

Example: 

r 9 

repeat 10 [pu fd 10 pd fd 101 
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pe 

Command/No inputs 

Stands for pen erase. Puts down the turtle’s eraser. When 
the turtle moves, it erases any lines it crosses. 

Example: 


r 9 

fd 50 


pe 

bk 50 


pos 

Reporter/No inputs 


Stands for position. Reports the coordinates of the turtle’s 
position as a list, [x y]. If there are several turtles 
following instructions, pos will report the position of the 
first turtle in the list reported by who. 

When you start LEGO® TC logo, turtle 0 is at position [0 
0]; turtle 1 is at [0 —40]; turtle 2 is at [ — 40 —40]; turtle 3 
is at [-40 0]. 

See setpos. 

Examples: 

r 9 

show po5 
[0 0 ] 
bk 50 
show pO5 
[0 -501 
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print word/list 
pr word/list 

(print word/listl word/list2...) Command/1 input 
If inside parentheses, one or many inputs. 


Prints the word or list on the page, followed by a carriage 
return. Outermost brackets of lists are not printed. 

Note: Printing on the procedure side of the page can cause 
unexpected results, since the new text may interfere with 
existing procedures. 

See insert, show, and type. 

Examples: 

cleartext 
pr "hello 
hello 

pr [hello there! 
hello there 
pr 22 / 7 
3.1429 

(pr [hello there] 

hello there Sam 


This appears on the page. 
This appears on the page. 

This appears on the page. 

"Sam) 

This appears on the page. 


printnames Command/No inputs 

Prints all variables in memory. Variables are created with 
make and name. 

See make and name. 

Example: 

make "age 8 
name "Cathy "friend 
print names 
:friend is "Cathy 
:age is 8 
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printscreen 


Command/No inputs 


Prints on a printer all the text and graphics that are visible 
on the page. Text in the Command Center and the title line 
of the page are not printed. 

Note: If your printer does not respond properly, check the 
printer setting on your LEGO® TC logo disk. If the type of 
printer specified is not the type you are using, change the 
printer setting on the disk. 

See printtext and the Setup Guide. 

Example: 

rg cleartext 

repeat 4 [fd 50 rt 90] 

pr "hello 

label "there 

printscreen 


printtext Command/No inputs 


Prints on a printer all the text on the current side of the 
page. This includes text which has scrolled above or below 
the screen. Text printed with the label command is not 
printed. 

Note: If your printer does not respond properly, check the 
printer setting on your LEGO® TC logo disk. If the type of 
printer specified is not the type you are using, change the 
printer setting on the disk. 

See printscreen and the Setup Guide. 

Example: 

repeat 15 [pr "hello] 
printtext 
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Command/No inputs 


pu 


Stands for pen up. Picks the turtle’s pen up. When the 
turtle moves, it does not draw or erase. 

Example: 

r 9 

repeat 10 [pu fd 10 pd fd 10] 


pulsewidth, pw Reporter/No inputs 

Reports the length of time in l/1000ths of a second 
between the last two increases on the counter. A pulse 
starts when the counter increases by one and ends the 
next time the counter increases. If both port 6 and port 7 
were named in the last listento instruction, pulsewidth 
reports a list with the values from both ports. The value 
received from port 6 is listed first. 

Examples: 

listento 6 
show pulsewidth 
428 

lto [6 7] 
show pw 
[428 951] 
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px 


Command/No inputs 


Puts down the turtle’s reversing pen. When the turtle 
moves, it draws lines where there aren’t lines and erases 
where there are lines. 

Example: 

r 9 

px 

repeat 10 [fd 50 bk 50 rt 9] 
repeat 8 [fd 50 rt 90] 
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R 


random number Reporter/1 input 

Reports a random non-negative integer less than number. 

A non-negative integer is a whole number greater than or 
equal to zero. 

Examples: 

show random 10 

4 Prints a number smaller than 

10 . 

onfor random 100 


rd 


Command/No inputs 


Stands for reverse direction. Reverses the direction of 
motors connected to the motor port(s) named in the last 
talkto instruction. 

See seteven and setodd. 

Example: 

talkto "a 
on 
r d 
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readchar 


Reporter/No inputs 


Stands for read character. Reads a character from the 
keyboard and then reports the character. If no character is 
waiting to be read, readchar waits until the user types 
something. The character is not printed on the screen or 
shown in the Command Center. 

See readlist and readlistcc. 

Examples: 

if readchar = "h [show "hello] 

Type an h. 
hello 

show ascii readchar 
Type an a. 

97 
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readlist 


Reporter/No inputs 


Reads a line that is typed onto the page and reports it as a 
list. Readlist waits for the user to press the Return Enter 
key before reading the line. 

Note: The only characters read are those typed in after the 
instruction using readlist is run. The arrow keys cannot 
be used to move the cursor onto text that was previously 
printed. Readlist cannot read a line that was previously 
typed on the page. 

See readlistcc and readchar. 


Examples: 

cc cleartext 
show readlist 

Type: 

hello there 


The cursor on the page is 
blinking. 


[hello there! This appears in the 

Command Center. 

pr " 

insert [What is your name?] 

What is your name? This appears on the page, 

make "my name readlist The cursor on the page 

begins blinking. 

Type your name and press Return Enter: 

What is your name? Terry Brown 

This appears on the page. 

show :myname 

[Terry Brown] This appears in the 

Command Center. 
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readlistcc 


Reporter/No inputs 


Stands for read list from Command Center. Reads a line 
that is typed into the Command Center, and reports it as a 
list. Readlistcc waits for the user to press the Return Enter 
key before reading the line. 

Note: The only characters read are those typed in after the 
instruction using readlistcc is run. The arrow keys cannot 
be used to move the cursor onto text that was previously 
printed. 

See readlist and readchar. 

Examples: 

cc 

show readlistcc 
hello there 

[hello there] This appears in the Command 

Center. 

Define this procedure. 

to question 

type [Type your name:] 
make "myname readlistcc 
end 

In the Command Center, type: 

question 

Type your name: 

Type your name and press Return Enter. 
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recycle Command/No inputs 

Performs a “garbage collection” in the computer’s memory, 
freeing up unused memory space. Adding a recycle 
command to large, complex programs can help them run 
more quickly, and can help prevent LEGO® TC logo’s 
automatic garbage collection from slowing down a program 
at the wrong time. Always use a recycle command before 
using space to find out the true amount of available 
memory. 

See space. 

Example: 

recycle 
show space 


remainder number 1 number2 Reporter/2 inputs 


Reports the remainder, if any, after numberl is divided by 
number2. If there is no remainder, remainder reports 0. 

Examples: 

show remainder 12 5 
2 

show remainder 10 5 
0 


repeat number list-to-run Command/2 inputs 

Runs a list of instructions a given number of times. 
Examples: 

repeat 4 ttto 1 onfor 20 tto 3 onfor 20] 
listento 6 

repeat 5 [show counter wait 10] 
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replace wordl word2 _ Command/2 inputs 

Searches for wordl in the text on the page from the cursor 
position to the bottom of the text, and replaces the first 
occurrence of wordl with word2. If wordl isn’t found, the 
cursor will not move. 

See search and top. 

Examples: 

cleartext 

pr [to be or not to be] 

to be or not to be This appears on the page. 

□ 

top 

replace "be "walk 
to walkDor not to be 
replace "be "walk 
to walk or not to walkD 


resetc Command/No inputs 

Stands for reset counter. Resets the counter(s) to zero for 
the inlet port(s) named in the last listento instruction. See 
counter, listento, and Chapter 2, The LEGO® Sensors. 

Example: 

listento [6 71 
show counter 
[10 151 
listento 6 
resetc 

show counter 
0 

lto [6 71 
show counter 
[0 15] 
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resett Command/No inputs 

Stands for reset timer. Resets the main timer to zero. 

See resett#, timer, and timer#. 

Example: 

resett show timer 
0 


resett# timernumber _ Command/ 1 input 

Stands for reset timer timernumber. Resets timer 
timernumber to zero. There are four LEGO® TC logo 
timers: timer 0, timer 1, timer 2, and timer 3. Timer 0 is the 
main timer, so the command resett is the same as the 
instruction resett# 0. 

See resett, timer, and timer#. 

Example: 

resett# 1 show timer# 1 
0 


restore Command/No inputs 

Replaces the page that is showing with the version of that 
page that is on the disk. Any changes or editing done to 
either side of the page since it was loaded will be lost. If 
the page is new (there is no version of it on the disk) there 
is no change. 

Example: 

qetpaqe "traffic 
rg fd SO 
restore 
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The page comes back as it was 
originally. 


rg 

Command/No inputs 

Stands for reset graphics. Resets the graphics system to its 
original state: all drawings are erased, the turtle’s pen is 
down, and only turtle 0 is visible and following 
commands. The other three turtles are hidden and 
inactive. 

See eg. 

Example: 


fd 50 
ht 

tell 10 1 2 33 
label "there 

r 9 


right degrees 
rt degrees 

Command/1 input 


Turns the turtle degrees to the right. 

Examples: 

rt 90 
fd 50 
rt 45 
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run list-to-run 


Command or Reporter/1 input 


Runs list-to-run. If list-to-run reports, run reports the same 
thing. (In the IBM version, run can also take a word as 
input.) 

Examples: 

run [fd 501 
show run [2 + 4] 

6 

make "problem 12+3+5+6+1] 
show run iproblem 
1 7 
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s 


search word 


Command/1 input 


Looks for the first occurrence of word in the text on the 
page starting from the cursor position and going to the 
bottom of the text. 

Apple users: To search for a whole word only, you must 
add a backslash (\) and a space to the beginning of word 
and another backslash to the end of word. 

IBM users: To search for a whole word only, you must use 
the vertical bar character (j or|) at the beginning and end 
of word. 

See replace and top. 

Example: 

cleartext 
pr [Hello there] 

□ 

Hello there Hello there appears on 

□ the page. 

top 

search " there 
Hello therein 

APPLE 

top 

search " \ the\ □ 

There’s theD end. 

IBM 

top 

search "J the JD 
There’s theD end. 
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sensor? 


Reporter/No inputs 


Reports the state of the sensor(s) connected to the inlet 
port(s) named in the last listento instruction. The state of 
a sensor can be either true or false. If both port 6 and port 
7 were named in the last listento instruction, sensor? 
reports a list of the true/false states of both sensors. The 
state of the sensor connected to port 6 is listed first. If no 
sensor is connected to the port, sensor? reports false. 

See listento and Chapter 2, The LEGO ® Sensors. 

Examples: 

listento 7 
show sensor? 
true 

listento [6 7] 
show sensor? 

[false true] 
listento 6 

if sensor? [onfor 141 
waituntil [not sensor?] 
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sentence word/listl word/list2 

se word/listl word/list2 

(sentence word/listl word/list2 word/list3...) 

Reporter/2 inputs 
If inside parentheses, one or many inputs. 


Combines all of its inputs into one list and reports that 
list. If the inputs are lists, sentence combines them to 
make a single list. 

See list. 

Examples: 

show se "hello "there 

[hello there] 

show se [hello] [there] 

[hello there] 

show se "hello [there] 

[hello there] 


setdisk letter Command/1 input 

Sets the drive for saving and loading pages. The first drive 
is drive A, the second is drive B. 

See disk. 

Examples: 

setdisk "b 
content s 

To copy a page from drive A to drive B: 

setdisk "a 

9P "traffic Use one of your page names, 

setdisk "b 

Press Escape. 
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seteven 


Command/No inputs 

Sets the direction of motors to the “even direction.” 
Seteven affects only motors connected to motor ports 
named in the last talkto instruction. If a motor is set to the 
even direction, the red light to the right to the motor port 
(the light below the even number) lights up whenever you 
turn the motor on. 

See rd, setodd, and Chapter 1, The LEGO® Interface Box. 
Example: 

talkto "a 

repeat 10 [setodd onfor 10 seteven onfor 101 


seth degrees Command/1 input 

Stands for set heading. Sets the heading of the turtle to 
degrees according to the absolute headings shown 
below: 


270 


( 

) 

n 

10 


90 


See heading, right, and left. 

Examples: 

r 9 

show heading 
0 

seth 45 
fd 50 
seth 180 
fd 50 


90 


setodd 


Command/No inputs 


Sets the direction of motors to the “odd direction.” Setodd 
affects only motors connected to motor ports named in the 
last talkto instruction. If a motor is set to the odd 
direction, the red light to the left of the motor port (the 
light below the odd number) lights up whenever you turn 
the motor on. 

See rd, seteven, and Chapter 1, The LEGO® Interface Box. 
Example: 

talkto "a 

repeat 10 [setodd onfor 10 seteven onfor 10] 


setpos fxyj 


Command/1 input 


Stands for set position. Moves the turtle to the given 
screen position. 

See pos. 

Examples: 

r 9 

setpos [ 0 50 ] 
setpos [50 50] 
setpos [50 0] 
home 
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setpower level _Command/1 input 

Sets the amount of power sent to the outlet port(s) named 
in the last talkto instruction. The power controls the 
speed of a motor or the brightness of a light. Level can be 
any number from 1 to 7. When you start LEGO® TC logo 
each port is set to its maximum power level, 7. 

Examples: 

talkto 2 
on 

setpower 1 
setpower 4 


show word/list 

(show word/listl word/list2...) Command/1 input 
If inside parentheses, one or many inputs. 


Prints the word or list in the command center. A list is 
printed with its outer brackets showing. 

See type, print, and insert. 

Examples: 

cleartext 
show "hello 
hello 

show [hello there] 

[hello there! 
show 22/7 

3.1429 
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sin degrees Reporter/1 input 


Stands for sine. Reports the sine of degrees. 

Examples: 

show sin 45 
0.7071 
set h 45 

show sin heading 
0.7071 


space 


Reporter/No inputs 


Reports the amount of free memory space in the 
workspace. You should run recycle before using space to 
find out the true amount of available memory. The number 
reported represents both string space (the memory space 
used for the names of things such as variables, procedures, 
etc.) and node space (the memory space used to 
interconnect procedures, variables, etc.). 

In the Apple version, space reports memory space as a 
percentage of the total available. In the IBM version, space 
reports the actual number of bytes available. 

See recycle. 

Example: 

recycle 
show space 
80 


In this example, 20% of your 
memory is occupied by 
procedures, variables, etc., and 
80% is free. 
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st 

Command/No inputs 

Stands for show turtle. Makes the turtle visible. 

See ht. 

Example: 


r 9 

tell M 2 3] 

5 t 

ht 


startup 

Special word/Procedure name 


A special procedure name built into LEGO® TC logo. If a 
page has a procedure named startup, that procedure will 
run automatically when you get the page from Contents or 
with the getpage command. There can be only one startup 
procedure per page. 

Example: 

Define this procedure: 
to startup 

repeat 4 [fd 50 rt 90] 
end 

In the command center, type: 

namepage "square 
newpage 

getpage "square 
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stop Command/No input 

Stops the procedure that is running. If the procedure is a 
subprocedure, control returns to the superprocedure; 
otherwise, control returns to the Command Center. You can 
use stop only inside a procedure. 

Example: 

Define this procedure. 

to countdown inumber 
if :number = 0 [stop] 
show :number 
countdown rnumber - 1 
end 

In the Command Center, type: 

countdown 10 


stopall Command/No inputs 


Stops all running procedures and returns control directly 
to the Command Center. 
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T 


talkto port/portlist 

tto port/portlist Command/1 input 


Sets which outlet port or ports will be used to send 
commands. There are nine outlet ports (A, B, C, 0, 1, 2, 3, 
4, 5). 

See listento and Chapter 1, The LEGO ® Interface Box. 

Examples: 

talkto 5 
flash 10 5 
tto [a bl 
onfor 10 


tell turtle 

tell turtlelist Command/1 input 


Sets which turtle or turtles will follow instructions. There 
are four turtles (0, 1, 2, and 3). 

See ask, all, and who. 

Examples: 

r 9 

tell tO 1 2 31 

5 t 

fd 50 
show who 
CO 1 2 31 
tell 3 
It 90 
fd 50 


All 4 turtles move. 


Only turtle 3 moves. 
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thing name Reporter/1 input 

Reports the value of the variable name. You can create 
variables with the make and name commands. 

See make and name. 

Examples: 

make "class [Bob Alice Fred] 

show thing "class 

[Bob Alice Fred] 

show :c1 as s 

[Bob Alice Fred] 

make "Fred ta very nice guy] 

show thing "Fred 

ta very nice guy] 

show :Fred 

ta very nice guy] 

show thing last rclass 

[a very nice guy] 


timer 


Reporter/No inputs 


Reports the time on the main timer. The main timer shows 
the amount of time that has passed since the last resett 
instruction. Time is given in tenths of a second. 

See resett, resett#, and timer#. 

Example: 

resett wait 10 show timer 

1 0 
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timer# time rnumber Reporter/1 input 

Reports the time on timer timernumber, which is the 
amount of time that has passed since the last resett# 
timernumber instruction. 

Time is reported in tenths of a second. There are four 
LEGO® TC logo timers: timer 0, timer 1, timer 2, and timer 
3. Timer 0 is the main timer, so the primitive timer is the 
same as timer# 0. 

See resett, resett#, and timer. 

Example: 

resett# 1 wait 10 show timer# 1 
1 0 


to name Special word/1 input 

Indicates the beginning of a procedure definition. To can 
only be used on the procedure side of the page. 

Example: 

to square 

repeat 4 [fd 50 rt 90] 
end 
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tone frequency time 


Command/2 inputs 


Produces a sound with the pitch of frequency that lasts for 
the specified amount of time. Time counts in tenths of a 
second and can be any number from 0 to 255. Frequency 
can be any number from 37 to 9999. In the IBM version, 
values between 0 and 37 cause no sound to be played. In 
the Apple version, these values cause an error. 

The timing for tone is accomplished through the LEGO® 
TC logo slot card. The slot card must be in the computer 
for tone to work. 

Examples: 

tone 440 30 
tone 5222 30 
tone 440 120 


Note 

Frequency, by 

Octave 



B 

62 

123 

247 

494 

988 

A# 

58 

117 

233 

466 

932 

A 

55 

110 

220 

440 

881 

G# 

52 

104 

208 

415 

830 

G 

49 

98 

196 

392 

784 

F# 

46 

92 

185 

370 

740 

F 

44 

87 

175 

349 

698 

E 

41 

82 

165 

330 

659 

D# 

39 

78 

156 

311 

622 

D 

37 

73 

147 

294 

587 

C# 


69 

139 

277 

554 

c 


65 

131 

262 

523 


middle C 
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top 

Command/No inputs 

Moves the cursor on the page to the top of the text on the 
page. 

Example: 

cleartext 

print [hello there] 

hello there 

hello t h e r e appears on 

□ 

print [how are you?] 

the page. 

how are you? 

how are you ? appears on 

□ 

top 

Hello there 
how are you? 

the page. 

true 

Special Word 


Reports true. Used as input to if, ifelse, and, or, not, =, 
and equal? 

See false. 


Examples: 


if "true [show "hello] 
hello 

ifelse and "true "false [show 

[show 


goodbye 

if sensor? = "true [off] 


"hello] 
"goodbye ] 
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type word/list 

(type word/listl word/list2...) Command/1 input 
If inside parentheses, one or many inputs. 

Prints the word or list in the command center without 
adding a carriage return (the cursor does not move to the 
next line). 

See show, print, and insert. 

Example: 

type [show "hello] 
show "hello 

Press Return Enter. 

hello 


101 









w 


wait time Command/1 input 

Tells LEGO® TC logo to pause for time tenths of a second. 
Wait 10 causes a pause of one second. 

Example: 

tto "a 
on 

wait 15 
off 


waituntil true/false-list Command/1 input 

Tells LEGO® TC logo to wait until true/false-list is true 
before following another instruction. The input to 
waituntil must be an instruction list that reports either 
true or false when it is run. 

Example: 

Define this procedure. 

to t ouc h s t op 
talkto "a 
1is t en t o 6 
on 

waituntil t sensor?] 

off 

end 

Connect a motor to port A. Connect a touch sensor to 
port 6. 

touch 5 top The motor will turn off when 

you press the button on the 
sensor. 
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who 


Reporter/No inputs 


Reports the number or list of numbers of the turtles that 
are following instructions. If who is used in an instruction 
list run by each, it will report one turtle number at a time. 
See tell, ask, and each. 

Examples: 


r 9 

tell [01231 

5 t 

each [fd 20 * who] 


show who 

[01231 


turtle 0 doesn’t move; 
turtle 1 moves forward 20; 
turtle 2 moves forward 40; 
turtle 3 moves forward 60. 


ask [0 1] teach [rt 90 fd 50 * who]] 

Turtle 0 turns right. Turtle 1 
turns right and moves forward 
50. 

show who 

[ 0123 ] 


word wordl word2 

(word wordl word2 word3...) Reporter/2 inputs 
If inside parentheses, one or many inputs. 

Combines all of its inputs into one word and reports that 
word. 

Examples: 

show word "super "man 
superman 

show (word "stick "it "together) 
stickittogether 


103 










word? word/list Test Reporter/1 input 


Reports true if the input is a word; otherwise, it reports 
false. 

Examples: 

show word? "hello 
true 

show word? [hello] 
false 

show word? 123 

true 

if word? "hello [show count "hello] 

5 
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Section 3: Appendices 


This section contains three appendices covering technical 
issues and special LEGO® TC logo features. 

Appendix 1, LEGO® TC logo Primitives and Special 
Words, lists the names of all of the LEGO® TC logo 
primitives. They are listed in groups according to 
function: graphics primitives, word processing primitives, 
and so on. 

Appendix 2, LEGO® TC logo Messages, lists and describes 
every message that LEGO® TC logo prints when it 
encounters an error or computer hardware problem. 

Appendix 3, Glossary of LEGO® TC logo and Computer 
Terms, is a list of terms used in the LEGO® TC logo 
documentation or in other books on the Logo language. 

Appendix 4, Range of Turtle Coordinates, shows the 
difference between the size of Apple and IBM screens. 
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Appendix 1 

LEGO® TC logo Primitives and 
Special Words 


Screen 

cc 

eg 

clearpage 

cleartext 

Scrapbook 

contents 
erpage 
getpage (gp) 
load 

namepage (np) 
newpage 
pagelist 
restore 

Workspace 

recycle 

space 

Assigning 

clearnames 

make 

name 

name? 

printnames 

thing 


Disk 

disk 

dos* 

setdisk 

Controlling 

Instructions/Logic 

and 

if 

ifelse 

not 

or 

output (op) 

repeat 

run 

stop 

stopall 

Math 


/ 

* 

> 

< 

cos 

minus 

random 

remainder 

sin 

*IBM version only 
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Printer Commands 

printscreen 

printtext 

Pausing 

wait 

waituntil 

Text Editing / 

Words and Lists 

Sound 

tone 

ascii 

butfirst (bf) 

butlast (bl) 

char 

count 

empty? 

equal? 

first 

fput 

identical? 

insert 

item 

last 

list 

list? 

lput 

member? 

number? 

print (pr) 

replace 

search 

sentence (se) 

show 

top 

type 

word 

word? 

Graphics 

all 

ask 

back (bk) 

clean 

each 

forward (fd) 
heading 
home 
ht 

label 

left (It) 

pd 

pe 

pos 

pu 

px 

rg 

right (rt) 

seth 

setpos 

st 

tell 

who 
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Input 

button? 

key? 

paddle 

readchar 

readlist 

readlistcc 

Special Words 

end 

false 

startup 

to 

true 

Receiving Information 

counter 
listento (lto) 
pulsewidth (pw) 
resetc 
sensor? 


Sending Instructions 

alloff (ao) 
flash 
off 
on 

onfor 

rd 

seteven 
setodd 
setpower 
talkto (tto) 

Timers 

resett 

resett# 

timer 

timer# 
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Appendix 2 

LEGO® TC logo Messages 


This is a complete listing of the messages that LEGO® TC 
logo can print. 

) in wrong place 

A parenthesis was used incorrectly. Check that all 
parentheses are in matched pairs, with the same number of 
opening parentheses as closing ones. 

Can’t divide by zero 

A number cannot be divided by zero. Check the divisor 
you used. It may be a very small decimal that truncates to 
zero or a variable that has the value of zero. 

Can’t use adjacent ports 

You tried to use a lettered port and one of the numbered 
ports next to it. This happens if you talkto two adjacent 
ports at the same time, or if you talkto a port adjacent to a 
port that is already on. Use another port or turn off the 
adjacent port. 

Can’t use symbol in a page name* 

Certain symbols (such as + and . and *) cannot be used in 
page names. 

Can’t use to as a command 

The special word to was used incorrectly: either you typed 
it in the Command Center, or you put it inside a procedure. 
Check to see if you forgot to put end at the end of the 
previous procedure. To is only used to start a procedure 
definition. 

Disk full 

There is no more room on the disk you are using. If the 
page you are on has not been saved, switch to another disk 
to save the current page. 


*IBM version only 
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Disk is write protected* 

This message appears if you try to save a page to a disk that 
is write protected. 

Flash only likes numbers from 1 to 99 as input 

You can only use a number from 1 to 99 as input to flash. 

I don’t know how to name 

LEGO® TC logo tried to run a word that is neither the name 
of a primitive nor a procedure on the page. 

I don’t know what to do with name 

A line or instruction (typed in the Command Center or 
used in a procedure) began with a reporter. Every 
instruction must begin with a command. 

I’m having trouble with the disk or drive 

Either the disk is write-protected, there is no disk in 
the drive, the drive door is open, or there is some other 
problem of this type. Check the disk and the drive 
before continuing. 

I’m having trouble with the printer 

The printer may not have the “select” button on, or may 
have another problem, such as a paper jam or no paper. 
Check that a printer is connected, then check the paper 
and switches on the printer. If there is no visible problem, 
check the printer specification on your LEGO® TC logo 
disk. If the disk is not set up to work with the printer you 
are using, change the printer specification. 

Joystick or paddle not connected* 

This message appears if you use the primitive paddle or 
button? without connecting a joystick or paddle to the 
computer. 

Listento only likes 6, 7, or [6 7] as input 

You can only use the number 6, the number 7, or the list 
[6 7] as input to listento. 


Missing ] in name 

Check that all square brackets in the procedure name are in 
matched pairs, with the same number of opening brackets 
as closing ones. 

This message usually occurs when LEGO® TC logo is 
putting procedures into the workspace (for example, when 
you move down to the Command Center, get a page, or load 
a page). 

Missing [ in name 

Check that all square brackets in the procedure name are in 
matched pairs, with the same number of opening brackets 
as closing ones. 

This message usually occurs when LEGO® TC logo is 
putting procedures into the workspace (for example, when 
you move down to the Command Center, get a page, or load 
a page). 

Name can only be used in a procedure 
Stop or output was used in the Command Center. These 
commands are used to stop procedures, so you can use 
them only inside procedures. 

Name didn’t report anything to name 

A primitive or procedure requiring an input didn’t get one 
from the primitive or procedure following it. 

Name doesn’t like name as input 

Some primitives require a certain type of input; for 
example, math operations require numbers as input. Check 
the alphabetical listing in the Reference Guide for specific 
requirements. 

Name has no value 

The variable name was used, but it had not previously 
been assigned a value. You can give a variable a value by 
naming it on the title line of a procedure or with a make 
or name command. Use printnames to find out what 
variables are in memory. 
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Name is not true or false 

Name was used as an input to a primitive requiring true or 
false as input (for example, if, ifelse, and, or, not, and 
waituntil). 

Name is the name of a primitive 

A procedure was created using a name that LEGO® TC logo 
already uses for a primitive (forward, right, etc.). 

Primitive names can’t be used for your own procedures. 

Name needs more inputs 

The primitive or procedure name requires one or more 
inputs. Either no inputs were used with name or not 
enough inputs were used. Check the alphabetical listing in 
the Reference Guide for specific requirements. 

No more room for text on the page 

An instruction to paste or load caused the total number of 
characters on both sides of the page to exceed the 
maximum number the system will allow. 

Number too big 

The maximum number that LEGO® TC logo can use is 
10 12 - 1 (999999999999). 

Out of space 

There is no free memory left. The free memory is related 
to, but is not the same as, the amount of space on the page, 
since variables, for example, reside in a part of memory 
outside of the page. If this message occurs, either erase 
some procedures from the page, go to a new page, or use 
cleamames to clear all variables from memory. 

Page too big * 

The maximum size of a page depends on the available 
memory in the computer. If you create a page on one 
computer, then try to load the page on a computer with 
less memory, you might get this message. 


Page name must be less than number characters 

The name you used is too long for the computer to use as 
a file name. On Apple computers, page names can contain 
at most 12 characters. On IBM and IBM-compatible 
computers, page names can contain at most 8 
characters. 

Please name this page 

The current page needs to be named before it can be saved 
in the scrapbook. If you want to keep the page, use 
namepage to name it; if not, use clearpage to clear the 
page before leaving it. 

Setpower only likes numbers from 1 to 7 as input 

You can only use a number from 1 to 7 as input to 

setpower. 

Stopped!! 

The stop keys were pressed to halt an instruction or 
a procedure. 

There is already a page named name 

Two pages cannot have the same name; choose a different 
name. 

There’s no page named name 

The name used as input to getpage or load is not the name 
of a page on the disk. To see the names of the pages in your 
scrapbook, go to Contents or use pagelist. 

Too few items in name 

Name doesn’t have the required number of elements. For 
instance, the fifth element of a list was requested, but the 
list contains only four items. 

Too much inside ()’s 

Parentheses were incorrectly used; for example, there are 
too many parentheses inside other parentheses. Simplify 
the instruction. 
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Appendix 3 

Glossary of LEGO® TC logo and 
Computer Terms 


ASCII 

American Standard Code for Information Interchange. A 
code which represents characters numerically. 

brackets [ ] 

Characters used to surround lists in LEGO® TC logo. 

carriage return 

A character which causes the cursor to move to the first 
position on the next line (ASCII character 13). 

command 

A word that tells LEGO® TC logo to do something. All 
LEGO® TC logo instructions begin with a command. 

Command Center 

The bottom part of the screen where instructions are 
typed. It is not part of the page. 

conditional 

An instruction which causes LEGO® TC logo to do one 
thing or another, depending on whether a condition is met. 
If and ifelse are used to build conditional expressions. 

cursor 

A small white blinking square which indicates your place 
on the page or in the Command Center. The cursor shows 
where the next letter typed will appear. 
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down keys 

The key combination that moves the cursor from the page 
down to the Command Center. 

element 

A component of a LEGO® TC logo word or list. The 
elements of a list are words or other lists; the elements of a 
word are characters. 

empty list 

A list that has no elements. You write the empty list as [ ]. 

empty word 

A word that has no characters. You write the empty word 
as 11 . 

file 

An organized collection of information that has been 
stored on a disk. A LEGO® TC logo page is a file that 
stores text and graphics together. 

flip keys 

The key combination that flips the page from the procedure 
side to the turtle side or from the turtle side to the 
procedure side. 

global variable 

A variable which stays in memory even when no 
procedure is running or when pages are changed. In 
general, a variable is global when it is created with a 
make or name command. A variable whose value remains 
in memory only while a procedure is running is a local 
variable. For more information, see the listings for make 
and name. 

inlet port 

One of the two ports (port 6 and port 7) on the LEGO® 
interface box to which LEGO® sensors can be connected. 
These ports are used to receive information (messages) 
from the LEGO® sensors. 


input(s) 

The information that a LEGO® TC logo primitive or 
procedure needs to run. It may be provided directly, by 
putting a word or list after a procedure that needs an input, 
or indirectly, by using a reporter. 

instruction 

A LEGO® TC logo statement that starts with a command; a 
command followed by its input(s) or reporters which provide 
the input(s). 

interface box 

The connecting box through which the computer and the 
LEGO® pieces communicate (through which they “talk to’’ 
and “listen to” each other). 

list 

A sequence of words or lists, or words and lists, that begins 
and ends with brackets. Lists are one of the basic LEGO® TC 
logo units for handling information. 

local variable 

A variable whose value is in memory only while a procedure 
is running. A variable can be made local by naming it on the 
title line of a procedure. A variable whose value stays in 
memory even when no procedures are running is a global 
variable. 

next screen keys 

The key combination that causes the cursor to move down 
exactly one screenful. 

object 

A word or a list; the units that can be accepted as inputs by 
LEGO® TC logo primitives and procedures. 

optosensor 

A LEGO® sensor used to detect changes in the level of light, 
from dark to light or light to dark. The sensor reports true if 
it detects a change from light to dark. The sensor reports 
false if it detects a change from dark to light. 
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outlet port 

One of several ports on the LEGO® interface box to which 
you can connect LEGO® motors or lights; a port through 
which you can send commands to LEGO® motors and 
lights. 

output 

To give information to a preceding primitive or procedure 
in a LEGO® TC logo instruction. A primitive or procedure 
which outputs is called a reporter. 

page 

A LEGO® TC logo file that is part of your scrapbook. The 
procedure side of the page can contain procedures; the 
turtle side can contain graphics and text. When you select 
a page, it is displayed on the top part of the screen. 

parentheses ( ) 

Characters which are used in LEGO® TC logo instructions 
to group primitives or procedures in such a way as to 
control the sequence in which they are run. Parentheses 
can also be used with some LEGO® TC logo primitives to 
extend the number of inputs they can accept. 

port 

One of the sets of small holes in the LEGO® interface box 
to which you can connect LEGO® wires. Outlet ports are 
ports through which you can send commands to LEGO® 
motors and lights. Inlet ports are used to receive messages 
or information about the true/false state of LEGO® sensors. 

predicate 

A LEGO® TC logo procedure that reports true or false. 
Predicates are also called “test reporters.” 

previous screen keys 

The key combination that causes the cursor to move up 
exactly one screenful. 

primitive 

A word that is built into LEGO® TC logo. 


procedure 

A LEGO® TC logo instruction or series of instructions that 
has a name. 

procedure side 

The side of a LEGO® TC logo page on which you define 
procedures. 

quotation mark " 

A special character which marks the beginning of a word. 
A quotation mark is essential if a word is to be used as an 
input to a LEGO® TG logo primitive or procedure; 
otherwise, LEGO® TC logo will try to interpret the word 
as a procedure to run. 

recursive procedure 

A procedure that runs itself as a subprocedure. 

reporter 

A LEGO® TC logo primitive or procedure that can report 
some information such as a number, word, or list. 

scrapbook 

A collection of LEGO® TC logo pages (files) on a single 
disk. 

stop keys 

The key combination that stops a LEGO® TC logo 
procedure while it’s running. 

subprocedure 

A procedure that is run by another procedure; a 
procedure whose name is used in the definition of another 
procedure. 

superprocedure 

A procedure which uses one or more other procedures in 
its definition; a procedure that runs another procedure. 
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test reporter 

A LEGO® TC logo primitive or procedure that reports true 
or false, depending on the result of a test. 

touch sensor 

A LEGO® sensor that detects whether it is being pressed. 
The sensor reports true if its button is being pressed. The 
sensor reports false if its button is not being pressed. 

turtle side 

The side of a LEGO® TC logo page on which you do your 
drawing and writing. 

up keys 

The key combination that moves the cursor up to the page 
from the Command Center. 

variable 

A name that stands for some value. A name with a colon 
(:) in front of it is a variable. There are two types of 
variables: global variables and local variables. 

word 

A sequence of one or more characters, treated as a unit. 
Numbers are words in LEGO® TC logo. Words are 
separated by spaces and can contain a special character 
such as a space only if the space is preceded by a 
backslash. 

workspace 

The part of the computer’s memory that is available to hold 
variables and procedures as long as the computer is on. 
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Appendix 4 

Range of Turtle Coordinates 


The following pictures show the range of turtle coordinates 
of the Apple and IBM versions of LEGO® TC logo. 
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Apple -140 



139 


-89 


IBM 


-159 



160 
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Special Characters 

* asterisk, multiplication 
sign, 33 

/ backslash, 87 

[ 3 brackets, 117 

: colon, 64 

/ division sign, 34 

= equal sign, 34 

> greater than sign, 35 

< less than sign, 35 

- minus sign, 33 

( ) parentheses, 120 

+ plus sign, 33 

" quotation mark, 121 
] vertical bar, 87 

A 

addition, 33 

all, 36 

alloff, ao, 36 
and,37 

arrow keys, 26 
ascii, 37 
ASCII, 117 
ask,38 


B 

back, bk, 39 

beginning of line keys, 28 
bottom of page keys, 28 
brackets [], 117 

butfirst, bf, 39 
butlast, bl, 39 
button?, 40 


c 

carriage return, 117 
cc, 41 
eg, 41 
char, 42 
clean, 42 
clearnames, 43 
clearpage, 44 
cleartext, 45 
colon :, 64 
command, 117 
Command Center, 21, 117 
conditional, 117 
contents, 45 
Contents menu, 20 
Contents menu keys, 26 
copy keys, 27 

copying a disk, Setup Guide 
copying a page, 24 
cos, 45 
cosine, 45 

count, 46 
counter, 46 

cursor, 117 

D 

disk, 47 

division sign/, 34 
dos, 47 

down keys, 33, 118 
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E 

each, 48 
element, 118 
empty list, 49, 118 
empty word, 49, 118 
empty?, 49 
end, 49 

end of line keys, 28 
equal sign = , 34 

equal?, 50 

erase to end of line keys, 28 
erasing a page, 27, 50 
erpage, 50 
Escape key, 25 

F 

false, 51 
file, 20, 118 
first, 51 
Hash, 52 
flip keys, 118 
forward, fd, 52 
fput, 52 

G 

game paddles, 72 
garbage collection, 82 
getpage, gp, 53 
global variable, 118 
greater than sign >, 35 

H 

heading, 54 
home, 54 

ht, 55 
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I 

identical?, 56 

if, 56 
ifelse, 57 
inlet port, 13, 118 
input, 30-32, 119 
insert, 57 
instruction, 119 
interface box, 11, 119 
interface card, Setup Guide 
item, 58 

J 

joystick, 72 

K 

key?, 59 

L 

label, 60 
last, 61 
left, It, 61 

less than sign < , 35 
list, 61 
list, 119 
list?, 62 
listento, lto, 62 
load, 63 

local variable, 119 

lput, 63 

M 

make, 64 
member?, 65 
minus, 65 

minus sign -, 33 
multiplication sign *,33 


N 

name, 66 
namepage, np, 66 
name?, 67 
newpage, 67 
next screen keys, 26, 
node space, 93 
not, 68 
number?, 68 

o 

object, 119 
off, 69 
on, 69 
onfor, 70 
optosensor, 119 
or, 70 

outlet port, 11, 120 

output, op, 71 

output, 120 

P 

paddle, 72 

page, 20, 120 
copying, 24 
erasing, 20 
saving, 22 
pagelist, 72 
parentheses (), 120 

pd, 72 

pe, 73 

plus sign + , 33 
port, 120 
pos, 73 
predicate, 120 
previous screen keys, 


primitive, 29, 120 

print, pr, 74 

printer specification, Setup Guide 
printnames, 74 
printscreen, 75 
119 printtext, 75 

procedure, 121 
procedure side, 21, 121 
pu, 76 

pulsewidth, pw, 76 

px, 77 


Q 

quotation mark ", 121 

R 

random, 78 

rd, 78 

readchar, 79 

readlist, 80 

readlistcc, 81 

recursive procedure, 121 

recycle, 82 

remainder, 82 

repeat, 82 

replace, 83 

reporter, 121 

resetc, 83 

resett, 84 

resett#, 84 

restore, 84 

rg, 85 

right, rt, 85 
run, 86 


26, 120 
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s 

saving a page, 22 
scrapbook, 121 
search, 87 
sensor?, 88 
sentence, se, 89 
setdisk, 89 
seteven, 90 
seth, 90 
setodd, 91 
setpos, 91 
setpower, 92 
show, 92 
sin, 93 
sine, 93 
space, 93 
st, 94 

startup, 94 
stop, 95 

stop keys, 26, 121 
stopall, 95 
string space, 93 
subprocedure, 121 
subtraction, 33 
superprocedure, 121 

T 

Table of Frequencies, 99 

talkto, tto, 96 
tell, 96 

test reporter, 122 

thing, 97 
tinier, 97 
timer#, 98 
to, 98 
tone, 99 


top, 100 

top of page keys, 26, 28 
touch sensor, 15, 122 
true, 100 
turtle page, 20, 22 
turtle side, 21,122 
type, 101 

u 

up keys, 25, 122 

V 

variable, 122 

w 

wait, 102 
waituntil, 102 
who, 103 
word, 103 

word, 122 
word?, 104 

workspace, 21, 93, 122 
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